Aide de IMPVB: Index
Index de l'Aide de IMPVB 1.0

Pour apprendre à utiliser l'aide, appuyez sur la touche F1 ou sélectionnez l'option Aide sur

l'Aide dans le menu d'Aide.

Si le texte d'une rubrique ne tient pas complètement sur votre écran utilisez les touches de

tabulation pour le visualiser.

Concepts

Objectifs et Fonctionnalités du programme IMPVB

A Propos de IMPVB 1.0

Commandes

Menu Fichier

Menu Impression

Menu Fenêtre

Menu Aide

Gestion de la barre d'icônes

Clavier

Liste des Raccourcis Clavier

Procédures

Ouvrir un projet Visual Basic

Sélectionner les options pour l'impression du projet

Lancer l'impression du projet

Modifier les options d'impression

Configurer l'imprimante

Quitter le programme


Aide de IMPVB: Objectifs du programme
Objectifs de IMPVB 1.0

Ce programme a été développé afin de pallier à l'impossibilité devant laquelle se trouve

le programmeur sous Visual Basic 3.0, d'imprimer de façon correcte et performante ses

programmes.

En utilisant la fonction Imprimer de Visual Basic, le listing obtenu ne permet pas de

mettre facilement en avant la structure de programmation. J'ai développé

personnellement des programmes dont le listing complet dépassait les 800 pages. De

quoi avoir mal à la tête si on recherche une information précise.

Le principe qui a guidé le développement de ce programme a été de chercher à mettre

en avant la structure du programme, ce qui permettra alors de retrouver rapidement le

code recherché. C'est d'ailleurs pour cela que vous verrez que les options d'impression

des commentaires sont fournies: Les commentaires sont là pour guider le lecteur dans

les arcanes du programme. Il est donc essentiel de leur faire la part belle dans

l'impression.

Enfin, ce premier programme contient un petit module d'analyse qui permet de passer en revue

tous les fichiers d'un projet afin d'y rechercher certaines informations. Pour l'heure ces

informations ne concerne que les fichiers utilisées par le programme, entre autres les DLL

qu'on risque parfois d'oublier de distribuer. A l'avenir certaines autres fonctionnalités lui seront

ajoutées.

Le programme reste très simple à utiliser et, surtout, ne vous demande pas de sauvegarder tous

vos fichiers du projet sous forme de texte. Il le fait tout seul en appelant et commandant Visual

 Basic. J'ai testé le programme avec plusieurs machines sans rencontrer de problèmes. Si vous

en avez contactez moi. De même si vous avez des suggestions de développement.


Aide de IMPVB: A propos de
A propos de IMPVB 1.0

(C) Christophe TRICAUD - TISOFT

68, Bd Edgar Quinet

75014 Paris

Les fichiers qui doivent être distribués avec cette version sont:

* IMPVB.EXE	: Le programme lui même

* IMPVB.HLP	: Ce programme d'aide

* VBRUN300.DLL	: Librairie de fonctionnement du programme

* THREED.VBX	: Add in du programme

* COMMDLG.DLL	:	"	"

* CMDIALOG.VBX	:	"	"


Aide de IMPVB: Commandes du menu Fichier
Commandes du menu Fichier

Ouverture du projet Visual Basic (Touche de raccourcis: CTRL+F12)

Cette commande ouvre la boîte de dialogue Windows vous permettant de sélectionner le projet

que vous désirez imprimer. Ce projet, pour être valide, doit être un projet Visual Basic

Windows et contenir au moins une fenêtre ou un module. Une fois le projet sélectionné, la

 fenêtre de sélection des éléments à imprimer s'affiche.

Configuration de l'imprimante (Touche de raccourcis: CTRL+C)

Cette commande ouvre la boîte de dialogue Windows vous permettant de sélectionner votre

imprimante et choisir les options de cette imprimante.

Quitter (Touche de raccourcis: ALT+F4)

Vous permet de quitter le programme.


Aide de IMPVB: Commandes du menu Impression
Commandes du menu Impression

Impression du projet (Touche de raccourcis: CTRL+I)

Cette commande n'est disponible qu'à partir du moment où un projet a été sélectionné.

Elle affiche la fenêtre de sélection des éléments à imprimer, fenêtre automatiquement ouverte

lors de la sélection du fichier.

Options d'impression (Touche de raccourcis: CTRL+O)

Permet de définir les options qui guideront l'impression de votre code. Cette fenêtre permet par

exemple de choisir votre police d'impression, la taille des caractères, la façon dont les

commentaires seront imprimés.

Une fois validées ces options sont enregistrées automatiquement pour les utilisations ultérieures.


Aide de IMPVB: Commandes du menu Fenêtre
Commandes du menu Fenêtre

en Cascade

Permet de positionner les fenêtres en cascade sur la fenêtre principale.

en Empilement

Permet de positionner les fenêtre en empilement sur la fenêtre principale.

1,2,3

Permet de sélectionner la fenêtre avec laquelle on veut travailler.

Ces commandes ont peu d'intérêt, compte tenu du fait qu'il n'est possible d'afficher au

maximum 3 fenêtres.


Aide de IMPVB: Commandes du menu Aide
Commandes du menu Aide

Index

Permet d'afficher l'index de l'aide disponible du programme IMPVB.

Aide sur l'aide

Permet d'afficher l'aide pour utiliser le programme de gestion des fichiers d'aide.

A propos de...

Permet d'afficher l'écran à propos du programme IMPVB.

Il faut noter que vous pouvez à tout moment appuyer sur la touche F1 pour afficher un écran

d'aide contextuel


Aide de IMPVB: Gestion de la barre d'icônes
Gestion de la barre d'icônes

Pour accéder plus rapidement aux fonctionnalités du programme vous pouvez cliquer avec la

souris sur les icônes de la barre qui se situe sous le menu:

Ouvre la boîte de dialogue de sélection du projet.

Affiche l'écran des paramètres d'impression par défaut.

Affiche la fenêtre de sélection des éléments à imprimer.

Affiche l'index de l'aide.


Aide de IMPVB: Liste des raccourcis clavier
Liste des raccourcis clavier

CTRL+F12	:Ouvre la fenêtre de sélection d'un projet.

CTRL+C	:Ouvre la fenêtre de configuration de l'imprimante.

ALT+F4	:Permet de quitter le programme.

CTRL+I	:Affiche la fenêtre de sélection des éléments à imprimer.

CTRL+O	:Affiche la fenêtre de sélection des options d'impression.


Aide de IMPVB: Lancer l'impression
Lancer l'impression

Une fois que vous avez sélectionné les fenêtres et modules que vous voulez imprimer, à

l'aide de la fenêtre de sélection des fichiers, sélectionnez le bouton Imprimer de cette

fenêtre pour lancer l'exécution.

Il va alors s'afficher une fenêtre, intitulée 'IMPRESSION DU PROJET'. Cette fenêtre

vous explique quelles vont être les étapes de l'impression:

1) Lancer Visual Basic afin de convertir tous les fichiers nécessaires en format Texte.

2) Fermer Visual Basic et commencer l'impression et l'analyse des fichiers sélectionnés.

Pour lancer le processus, appuyez une nouvelle fois sur le bouton Imprimer.

L'appui sur le bouton Annuler vous ramènera à la feuille de sélection des fichiers.

DEROULEMENT DE LA PROCEDURE:

Pendant la première phase, il est vital que vous n'interveniez en aucune façon sur votre

ordinateur. En effet, le programme IMPVB envoie des commandes à Visual Basic, et toutes

 intervention de votre part serait interprétée de façon erronée par Visual Basic et conduirait à

planter le processus. Par contre, vous pouvez cliquer sur la touche Annuler, qui arrêtera alors le

programme en cours de route.

Pendant les 2 phases, une jauge vous indique en permanence ce que fait le programme et où

vous en êtes.


Aide de IMPVB: Quitter le programme
Quitter IMPVB 1.0

Pour quitter le programme, vous pouvez, au choix:

1) Sélectionner l'option Quitter du menu fichier.

2) Appuyez simultanément sur les touche ALT et F4.

3) Double cliquer avec la souris dans la boîte de contrôle en haut à gauche de l'écran.

Dans ce cas, le programme abandonne toutes les opérations en cours et s'arrête.


Aide de IMPVB: Ouvrir un projet
Ouvrir un projet

La première chose à faire, est, bien sur, de sélectionner le projet que vous désirez imprimer.

En sélectionnant l'option Ouvrir du menu Fichier (ou CTRL+F12 ou clique sur [image] ) vous

provoquez l'ouverture de la boîte de dialogue Windows de sélection d'un fichier. Cette boîte de

dialogue vous permet de sélectionner un fichier avec l'extension .MAK. Sur l'utilisation de

cette boîte de dialogue, voyez le guide d'utilisation de Windows.

Si vous ne sélectionnez pas un fichier *.MAK ou si ce fichier n'est pas un fichier Visual Basic 3

un message d'erreur est affiché et le projet n'est pas chargé. Le programme ne gère pas les

versions précédentes de Visual Basic.

Une fois votre sélection validée, le programme va charger le projet et vous afficher la fenêtre

de sélection des fichiers du projet que vous désirez imprimer.

Le nom du projet est affiché dans le titre de la fenêtre principale.


Aide de IMPVB: Configurer l'imprimante
Configurer l'imprimante

Vous pouvez, durant l'utilisation de ce programme, modifier les paramètres par défaut

d'impression de Windows. Pour ce faire vous devez sélectionner l'option

'Configuration de l'imprimante' du menu fichier (ou CTRL+C).

Vous provoquerez l'ouverture de la boîte de dialogue Windows de configuration de

l'imprimante. Vous pourrez, entre autres, sélectionner votre imprimante ainsi que l'orientation

de l'impression.

Pour l'utilisation de cette boîte de dialogue, reportez vous à votre manuel Windows.

ATTENTION! Les modifications que vous ferez dans cette boîte de dialogue, une fois

validées, seront valables pour toutes les autres applications Windows. Pensez à rétablir les

valeurs d'origine avant de quitter le programme IMPVB.


Aide de IMPVB: Sélection des éléments à imprimer
Sélection des éléments à imprimer

Après avoir sélectionné le projet avec lequel vous vouliez travailler, le programme vous

affiche la fenêtre de sélection des fichiers à imprimer.

Cette fenêtre affiche dans la partie gauche 2 listes déroulantes contenant les fenêtres et les

modules disponibles dans le projet. Dans les 2 listes de droite, elle affiche les fenêtres et les

modules sélectionnés pour l'impression.  En dessous de ces 4 listes se trouve une case à cocher

vous permettant de sélectionner l'impression de la page de récapitulatif. Enfin 3 boutons

 'Quitter', 'Imprimer' et 'Sélectionner' complètent cette fenêtre.

SELECTIONNER DES FENETRES OU DES MODULES

Pour sélectionner directement des fenêtres ou des modules vous pouvez:

1) double cliquer avec la souris directement sur leur nom. L'élément sélectionné disparaîtra de

la fenêtre de gauche pour apparaître dans la fenêtre de droite.

2) Effectuer une multiple sélection dans la fenêtre de gauche (avec les touches CTRL et SHIFT)

puis cliquer sur le bouton 'Sélectionner >>' de la fenêtre correspondant. Les fichiers

sélectionnés seront alors transférés dans la fenêtre de droite.

3) Cliquer sur le bouton 'Tous >>>>' de la fenêtre désirée. Tous les fichiers de la fenêtre de

gauche seront transférés dans la fenêtre de droite.

Au final, les 2 listes de droite devront afficher les éléments que vous désirez imprimer.

DESELECTIONNER DES FENETRES OU DES MODULES

Vous pouvez également annuler la sélection des éléments en effectuant les mêmes opérations

que ci-dessus, mais avec les boutons '<<Déselectionner' et '<<<< Tous'.

IMPRIMER LA PAGE DE RECAPITULATIF

Par défaut, la page de récapitulatif sera imprimée. Cette page imprime le nombre de fenêtres et

modules du programme, ainsi que la liste des modules externes nécessaires au programme:

Fichiers VBX et fichier DLL appelés.

Pour ne pas imprimer cette page, qui demande l'analyse de tous les fichiers de votre projet,

désélectionnez la case à cocher.

SELECTIONNER UNE MISE A JOUR

Le bouton 'Sélectionner' vous permet de sélectionner toutes les fenêtres et modules qui ont été

mis à jour à partir d'une date que vous fournirez.

Pour lancer cette sélection, cliquez sur le bouton. La date par défaut affichée est la date de

dernière modification du fichier de projet *.MAK.

Après avoir validé votre saisie (en appuyant sur la touche Entrée), toutes les fenêtres et

modules, qui n'avaient pas encore été sélectionnés, et dont la date de modification est

postérieure à votre date, seront basculés dans les fenêtre à imprimer.

Par contre, aucun mouvement ne sera effectué sur les fichiers déjà sélectionnés, même si leur

date est antérieure à celle que vous avez fournie.

Cette fonction permet de n'imprimer que les fenêtres et modules ayant été modifiés depuis

votre dernière impression.

LANCER L'IMPRESSION

Cliquez sur le bouton Imprimer pour lancer la procédure d'impression. La fenêtre d'impression

s'affiche alors.


Aide de IMPVB: Modifier les options d'impression
Modifier les options d'impression

Le principal intérêt de ce programme est de vous permettre d'améliorer la présentation de vos

listings de programme grâce à des options de mise en forme avancées. Pour les sélectionner,

choisissez l'option 'Options d'impression' du menu Impression (ou CTRL+I ou cliquez sur [image])

CHEMIN D'ACCES A VB.EXE

Vous devez indiquer ici le chemin d'accès au programme Visual Basic. :Par défaut, le

programme vous indique le chemin d'accès présent dans le fichier WIN.INI. Le programme

contrôle la validité de votre saisie.

POLICE D'IMPRESSION

Choisissez la police que vous désirez utiliser pour l'impression. La fenêtre vous présente dans

une liste déroulante les polices disponibles pour votre imprimante. Pour en sélectionner une, il

suffit de cliquer dessus. Par défaut, le programme choisit la première.

TAILLE DE LA POLICE

Vous pouvez sélectionner la taille d'impression du code. Cette taille peut prendre les valeurs

8,10,12,14. Pour une taille de 8, munissez vous d'une loupe. Quant à une taille de 14, c'est

vraiment très gros. Mais à vous de faire votre choix. Toutes les tailles des titres et des sous

titres s'effectueront à partir de cette sélection. Je recommande néanmoins la taille par défaut,

c'est à dire 10. Bon compromis entre la qualité de lecture et la quantité d'information

disponible.

CESURE AUTOMATIQUE

Lorsqu'une ligne de code est trop longue pour être imprimée sur une seule ligne, elle est coupée, et

un signe >> s'inscrit dans la marge pour indiquer que la ligne continue.

Si la césure automatique est validée, alors la coupure dans la ligne de code se fera au niveau d'un

caractère blanc. Autrement, la coupure se fera éventuellement au milieu d'un mot.

Par défaut la césure est validée, et je vous le recommande.

SAUT DE PAGE AVANT CHAQUE FENETRE/MODULE

Lorsque cette option est validée, le programme commence une nouvelle page à chaque fenêtre ou

module qu'il doit imprimer. Ceci permet de séparer très clairement les différents fichiers

constituant votre application, et vous permet de mettre à jour les éléments ayant évolués sans

avoir à tout réimprimer.

Par défaut l'option est validée, et je vous le recommande.

IMPRIMER LES FENETRES AVANT LES MODULES

Si l'option est validée, le programme imprime le code des fenêtres sélectionnées avant le code

des modules. Ce qui est conforme à la présentation de Visual Basic, mais pas à la logique.

En effet, les modules contiennent les définitions des variables globales, des fonctions et routines

globales et devraient donc, à ce titre, être imprimés d'abord. A vous de voir.

Par défaut l'option est validée.

IMPRIMER LES COMMENTAIRES

Si l'option est validée, les commentaires seront imprimés avec les paramètres qui suivent. Sinon les

commentaires ne le sont pas.

Par défaut l'option est validée, et cela me paraît inconcevable de ne pas la valider. Mais c'est vous

le patron.

ITALIQUE

Dans ce cas les commentaires sont imprimés en italique. Par défaut.

GRAS

Dans ce cas les commentaires sont imprimés en Gras. Par défaut.

TRONCATURE AUTOMATIQUE

Si cette option est validée, les commentaires qui dépassent la largeur d'impression de la page sont

perdus. Dans le cas inverse, ils s'écriront sur autant de lignes que nécessaires.

Par défaut, l'option est validée. Je le recommande car il vaut mieux, dans le code d'un programme,

que les commentaires soient cours et sur plusieurs lignes si nécessaires, afin qu'ils puissent être lus

sur votre écran.

FOND DE COULEUR

C'est un emprunt à la coloration syntaxique qui fait des ravages chez les programmeurs. Si cette

option est validée, les commentaires s'imprimeront sur un fond de couleur. Ce qui permettra de

mettre très facilement en avant la structure du programme. Le code étant clairement séparé des

commentaires.

Par défaut l'option est validée et je le recommande.

JUSQU'A LA FIN DE LA LIGNE

Cette option vient compléter la précédente. Si elle est validée, alors, quelle que soit la longueur du

commentaire à imprimer, la ligne colorée sera imprimée jusqu'au bord gauche de la feuille. Ceci

permet de découper proprement son programme. Essayez.

Par défaut cette option est validée.

LES BOUTONS

'Valider' permet d'enregistrer les modifications que vous avez apportées aux options.

'Annuler' ferme la fenêtre sans sauver vos modifications.

'Défaut' restaure les options d'impression initiales.

J'ai testé toutes ces options sur des imprimantes H.P. sans aucun problème. Si tel n'était pas le cas

dans votre utilisation, contactez moi.